Skip to content

Eval: run a code string - #487

Merged
gabifs merged 2 commits into
javascript-tutorial:masterfrom
diogoosz:translate-eval
Nov 21, 2026
Merged

gabifs merged 2 commits into
javascript-tutorial:masterfrom
diogoosz:translate-eval

Conversation

@diogoosz

@diogoosz diogoosz commented Nov 9, 2026

Copy link
Copy Markdown
Contributor

Tradução do artigo "Eval: run a code string" para o português, incluindo o exercício.

Conforme comentado na #1.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Porém, o usuário pode digitar qualquer texto ou código.

To make things safe, and limit it to arithmetics only, we can check the `expr` using a [regular expression](info:regular-expressions), so that it only may contain digits and operators.
Para deixar as coisas seguras, e limitar só a aritmética, podemos verificar `expr` usando uma [expressão regular](info:regular-expressions), de forma que ela só possa conter dígitos e operadores.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Tradução muda o sentido: "limitar só a aritmética" se lê como "restringir apenas a aritmética", o oposto do original ("limit it to arithmetics only"). Sugestão:

Suggested change
Para deixar as coisas seguras, e limitar só a aritmética, podemos verificar `expr` usando uma [expressão regular](info:regular-expressions), de forma que ela só possa conter dígitos e operadores.
Para deixar as coisas seguras e limitá-la apenas à aritmética, podemos verificar `expr` usando uma [expressão regular](info:regular-expressions), de forma que ela só possa conter dígitos e operadores.

Comment thread 1-js/99-js-misc/02-eval/article.md Outdated
```

The eval'ed code is executed in the current lexical environment, so it can see outer variables:
O código executado pelo eval roda no Ambiente Léxico atual, então ele consegue ver as variáveis externas:

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Terminologia inconsistente: "Ambiente Léxico" (também nas linhas 57 e 68) diverge de "Ambiente Lexical", usado em 1-js/06-advanced-functions/07-new-function/article.md — capítulo linkado por este mesmo artigo (<info:new-function>). Leitor encontra dois termos para o mesmo conceito. Padronizar em "Ambiente Lexical".

Comment thread 1-js/99-js-misc/02-eval/article.md Outdated
Observe que sua capacidade de acessar variáveis externas tem efeitos colaterais.

Code minifiers (tools used before JS gets to production, to compress it) rename local variables into shorter ones (like `a`, `b` etc) to make the code smaller. That's usually safe, but not if `eval` is used, as local variables may be accessed from eval'ed code string. So minifiers don't do that renaming for all variables potentially visible from `eval`. That negatively affects code compression ratio.
Minificadores de código (ferramentas usadas antes do JS ir pra produção, pra comprimi-lo) renomeiam variáveis locais para nomes mais curtos (tipo `a`, `b` etc.) pra deixar o código menor. Isso normalmente é seguro, mas não quando `eval` é usado, já que variáveis locais podem ser acessadas a partir da string de código do eval. Então os minificadores não fazem essa renomeação para todas as variáveis potencialmente visíveis a partir do `eval`. Isso afeta negativamente a taxa de compressão do código.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Registro informal ("pra produção", "pra comprimi-lo", "tipo a, b", "pra deixar") destoa do resto do artigo, que usa "para" — e a própria frase mistura "pra" e "para". Sugestão: trocar por "para" / "como a, b etc.".

Comment thread 1-js/99-js-misc/02-eval/article.md Outdated
@@ -1,25 +1,25 @@
# Eval: run a code string
# Eval: executa uma string de código

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Título: "executa" (3ª pessoa) soa como frase descritiva, não título. Outros títulos do tutorial usam substantivo/infinitivo. Sugestão: # Eval: executando uma string de código ou # Eval: executar uma string de código.

Comment thread 1-js/99-js-misc/02-eval/article.md Outdated
Uma chamada a `eval(code)` roda a string de código e retorna o resultado da última instrução.
- Raramente usado no JavaScript moderno, já que normalmente não há necessidade.
- Pode acessar variáveis locais externas. Isso é considerado má prática.
- Em vez disso, para executar o `eval` do código no escopo global, use `window.eval(code)`.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Construção truncada: "executar o eval do código" não faz sentido. Sugestão: "Em vez disso, para executar o código com eval no escopo global, use window.eval(code)."


```js demo run
let expr = prompt("Type an arithmetic expression?", '2*3+2');
let expr = prompt("Digite uma expressão aritmética?", '2*3+2');

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pergunta com imperativo: "Digite uma expressão aritmética?" — o "?" herdado do original fica estranho em português. Sugestão: prompt("Digite uma expressão aritmética:", '2*3+2').

- Fix title: "Eval: executa uma string de código" -> "Eval:
  executando uma string de código" (noun/infinitive style used by
  other titles)
- Standardize "Ambiente Léxico" -> "Ambiente Lexical", matching the
  term used elsewhere in the repo (linked from <info:new-function>)
- Standardize informal "pra" to "para" and "tipo" to "como"
- Fix truncated phrasing: "executar o eval do código" -> "executar o
  código com eval"
- Fix inverted meaning: "limitar só a aritmética" -> "limitá-la
  apenas à aritmética"
- Drop the stray "?" from the imperative prompt() question

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@diogoosz

Copy link
Copy Markdown
Contributor Author

Obrigado, @gabifs! Apliquei tudo: título ajustado, "Ambiente Léxico"→"Ambiente Lexical", padronizei "pra"/"tipo" pra "para"/"como", corrigi "executar o eval do código", corrigi o sentido invertido em "limitar só a aritmética", e tirei o "?" da pergunta imperativa do prompt.

@gabifs
gabifs merged commit c23e540 into javascript-tutorial:master Nov 21, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants